Manage Hidden Variables

This section describes inheritance variables and the associated commands.

As the name suggests, the value of these variables is hidden from the user in interfaces and logs. Variables and their values are stored in a special file. The variable name appears in ASCII, its value is encoded. Hidden variables are not Uproc variables; they can be used anywhere in Dollar Universe.

The Company’s logical environment (unienv) should be loaded before any of these commands can be used.

The command uxhideval INSERT creates a variable and its hidden value in the variable definition file. Its syntax is as follows:

uxhideval [AREA] INSERT [FILE=filename] VAR=varname VAL=value

The command uxhideval LIST lists variables in the file. Its syntax is as follows:

uxhideval [AREA] LIST [FILE=filename] VAR=varname

The command uxhideval DELETE deletes a variable and its value from the file. Its syntax is as follows:

uxhideval [AREA] DELETE [FILE=filename] VAR=varname

The command uxhideval EXTRACT retrieves the value of a variable from the file. Its syntax is as follows:

uxhideval [AREA] EXTRACT [FILE=filename] VAR=varname

The command uxexechidden executes a command using the value of one or more hidden variables (the command displays the result of its execution together with the standard output of the command passed as a parameter). This command must be executed within a Uproc script launched by Dollar Universe. Its syntax is as follows:

uxexechidden [FILE=filename] <command> !HIDDEN_varname! !HIDDEN_varname!

Description of Items

• AREA

  (Optional) Area for which the command has been defined. By default the value of the environment variable S_ESPEXE will be used and will take the value of the Area where the job is run. Enter:

  • EXP for the Production Area
  • SIM for the Simulation Area
  • INT for the Integration Area
  • APP for the Application Area

• FILE=

  (Optional) Enter the address of the file which will contain the variable definitions.
  The first time the command uxhideval … INSERT is used, the file is created with the rights of the user who executed the command.
  If this item is used with the uxexechidden command, it must be in first position (see example below).
  If a command cannot access the file, it will end in error.

  Format: 256 characters maximum for the path and 256 characters maximum for the file name. The address must not contain any spaces or tab characters.

  Default: the file hidevalues.dta in the company’s root directory (UNI_DIR_DATA).

• VAR=

  Name of the variable.
  Format: Maximum 256 characters. The variable name must not contain spaces or tab characters. The wildcard character “*” may be used with uxhideval … LIST command.

• VAL=

  Value of the variable. This value will not be visible to the user.
  Format: Maximum 256 characters. The value must not contain spaces or tab characters

• command

  Command to be executed. The command accepts as a parameter the value of the hidden variable specified (!HIDDEN_variable_name!) in the variable definition file. The same command may accept several hidden variables as parameters.

Examples

• Create the variable COUNTRY with the hidden value “New Zealand” in the file $UXMGR/HiddenValues for the Production Area.

  $UNI_DIR_EXEC/uxhideval EXP INSERT var=COUNTRY val=New_Zealand file="$UXMGR/HiddenValues"

• Create the variable DURATION with the hidden value “120” in the file $UNI_DIR_DATA/hidevalues.dta for the Production Area.

  $UNI_DIR_EXEC/uxhideval EXP INSERT var=DURATION val=120

• List all variables (without their values) from the file $UXDIR_ROOT/hidevalues.dta for the Production Area.

  $UNI_DIR_EXEC/uxhideval EXP LIST var=*

• Display the value of the variable DURATION if it exists in the file $UXDIR_ROOT/hidevalues.dta for the Production Area.

  $UNI_DIR_EXEC/uxhideval EXP EXTRACT var=DURATION

• Run the command “sleep” to accept as a parameter the value of the hidden variable DURATION from the default file for the Production Area.

  $UNI_DIR_EXEC/uxexechidden sleep !HIDDEN_DURATION!

• Run the command "/tmp/script.sh" to accept as a parameter the value of the hidden variable COUNTRY from the file $UXMGR/HiddenValues.

  $UNI_DIR_EXEC/uxexechidden file=$UXMGR/HiddenValues /tmp/script.sh !HIDDEN_COUNTRY!

• Delete the variable COUNTRY from the file UXMGR/HiddenValues if it exists fro the Production Area.

  $UNI_DIR_EXEC/uxhideval EXP DELETE var=COUNTRY file="$UXMGR/HiddenValues"

• Display in the job output the values of the two hidden variables, defined in the default file:

  $UNI_DIR_EXEC/uxexechidden echo !HIDDEN_COUNTRY! - !HIDDEN_DURATION!

  New_Zealand - 120